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6- EXAMPLES AND APPLICATIONS 


This section presents detailed examples of applications of the User's 
Manual. These example applications are described in a simple, step-by-step 
procedure in terms that are sufficiently detailed such that an interested 
programmer/analyst could modify the existing CATTS mathematical model data 
base (i.e., CATTS scenario) or compile a completely new data base. Included 


are descriptions of: 
e How to input the data that defines a unit. 
@ How to implement a new unit type. 
e How to implement a new equipment type. 
e@ How to change the weapon effects data. 
e How to change the modes of equipment operation. 


Much of the information needed by the user programmer/analyst to 
modify or develop the CATTS data base is available in other sections of 
this manual as well as in other CATTS documentation such as the Data Base/ 
Operations Manual, the Operator's Manual, and the Trainer Programming 
Report. The applicable sections of the User's Manual are Section 3, 
Definition of Terms, Section 4, Description of Data Tables; and Appendix A, 
Nomenclature List. Section 3 provides definitions for 163 of the major 
"terms" used in the model. An understanding of these terms is essential 
to an understanding of the intrinsic concepts inherent in the CATTS mathe- 
matical model. Section 4 provides a description of 27 of the key data 
tables contained in the data base. Many of these tables have a complex 
structure and, in several cases, there are interactions between entities 
in other tables. Thus, it is important that the user programmer/analyst 
understand the model's usage of these tables when constructing or modify- 
ing a data base scenario. Appendix A provides additional assistance by 
presenting a detailed definition of each of the more than 330 global vari- 
ables used in the model. 


The nomenclature definitions also include information to indicate 
whether the variable is a single-valued scalar variable or a dimensioned 
array. Since most of the input variables have at least one array index and, 
in many cases, two or three indices, the total number of input data values 
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necessary for a complete data base can exceed 20,000 data values. Thus, it 
is clear that the construction of a complete data base is certainly a non- 
trivial task. 


It should be pointed out, here, that the aforementioned 20,000 data 
values are those data variables that pertain to the tactical scenario only 
and do not include the additional data needed to describe the attributes 
of military terrain; namely, relief, vegetation, soil, cultural features 
and the like. The current CATTS data base has a terrain data base that 
contains upwards of 5 million data points. The incorporation of this mass 
of data, in a usable form, into the CATTS data base was accomplished with 
the assistance of the Defense Mapping Agency (DMA). DMA provided computer 
tapes containing digitized data representing the terrain features in the 
area to be represented in the current scenario. Thus, it was not a massive 
manual task but was instead a relatively straightforward computer-to~-computer 
task to produce the terrain data base portion of the overall data base. If 
it were desired to produce a new CATTS scenario (say, the FULDA Gap of West 
Germany) it would be necessary to procure the required data tapes, properly 
formatted, from the DMA. 


Therefore, it is the intent of this section to: 1) introduce the 
basic concepts pertaining to the CATTS mathematical model data base organi- 
zation and structure that the user must be aware of in order to modify the 
data base; and 2) describe the basic steps associated with changing the 
CATTS simulation via the data base and present specific examples of how 
these steps will allow the user to change the simulation. 


6.1 GENERAL DATA BASE CONCEPTS 


6.1.1 Data Deck Organization 


As is quite usual in data driven simulation models, having large 
input data bases, the data is often organized into various smaller sized 
input decks. The CATTS data base has a total of 29 individual input decks 
that include all the required tactical scenario data and five computer 
files that contain the terrain data base. One additional] file, the Pre- 
scheduled Events File, contains input data relating to the occurrence of 
specific events. This file will be discussed in Section 6.1.1.3. Insofar 
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as was practically possible, each of the 29 input decks was organized to 
facilitate the coordinated gathering and input preparation of the various 
classes of data that were of a generally similar nature. The 29 different 
input data decks are identified in Table 6-1. As shown, the decks are 
combined into 9 logical groupings (for discussion purposes only). The 
table also includes the names of the various subroutines that are called by 
the main model's subexecutive program (FORMAIN) to “read in" all of the 
necessary input data. The following sections will discuss the general 
content of each input deck, in each of the logical groupings, in the same 
order as they are presented in Table 6-1. Throughout the balance of this 
section there may be references to input variables by their acronym without 
defining the acronym. If the reader desires to know the variable's defini- 
tion it is available in the alphabetized list of global variables found in 
Appendix A of this User's Manual. 


It should be pointed out, here at the outset, that if a completely 
new data base were to be compiled that the user programmer/analyst(s) 
should make maximum use of the current CATTS data base, both as a guide 
and as a source of specific input data values. Much of the existing data 
would be applicable for other scenarios regardless of their geographical 
setting or composition of forces. For example, an H-Series TOE armor 
platoon would not change even though the geographical setting changed from 
the Mid East to Central Europe. Another word of caution, with respect to 
constructing (or modifying) a data base is that, because there is a high 
degree of interrelationship between various input decks, it is not neces- 
sarily true that specific entries in one input deck are sufficient to 
accomplish the desired effect. For example, if it is desired to add an 
additional unit to an existing data base, one must ensure that the Unit 
Type input deck includes a definition of the particular type of unit. If 
it does not, then an additional set of entries must be developed to des- 
cribe the new unit type. Furthermore, if the new unit includes equipments 
(weapons) not previously included in the simulation, then new entries will 
be required in both Equipment Data decks. Also, new entries may be neces- 
sary in the Target Acquisition Data deck if new sensors are included. 
Other input decks can and probably will be affected as well. The point is, 
that the user must have a clear understanding of the content of each input 
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deck and make a determination as to whether any other deck(s) are affected 
by changes or additions to any specific input deck. Table 6-1 can assist 
in this task since it presents a listing of input decks organized into 
logical groupings. 


Each of the following sections will include a computer produced 
alphabetized list of all the variables in each input deck being discussed 
in the section. Each entry includes the variable name, it's index, the 
input deck in which it appears, and the common block in which it resides. 


6.1215) Unit data 


The requisite input data relative to the "units" to be included in the 
simulation is compiled in either the Unit Description input deck or the 
Unit Type input deck. Table 6-2 presents a list of the Unit Description 
input variables that must be defined for each of the units to be simulated. 
As noted, the variables define such as number of personnel, number of 
weapons (equipments) by type, ammunition basic loads, initial location, area 
occupied, and various operational parameters. 


Table 6-3 presents a list of the Unit Type input variables that must be 
defined for each type of unit that is to be simulated. Examples of unit 
types defined in the current scenario include mechanized infantry, armor, 
armored cavalry, artillery, combat engineers, and various combat service 
support units. 


In addition to the data of Tables 6-2 and 6-3, there are several por- 
tions of Section 3 wherein are defined a series of terms (as opposed to 
input variable definitions) that are of special significance to the Unit 
Description and Unit Type input decks. They are Sections 3.14, 3.18, 3.42, 
3.46, 3.89, 3.101, 3.104, 3.105, 3.145, 3.148, 3,750, 3.152, and 3.153. 


The main purpose of presenting Tables 6-2 and 6-3 in this section and 
the tables to follow in subsequent sections is to aid the user by provid- 
ing a compact list of variables, organized into logical grouping. These 
variable lists when used in conjunction with the detailed definitions of 
Appendix A will provide the insight needed to ensure the correct speci fica- 
tion of input variables regardless of whether the analyst is developing a 
complete scenario or modifying an existing scenario. 
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6.1.1.2 Equipment Data 


The mass of data required to define the performance parameters des- 
cribing each equipment (weapon or non-weapon) included in the simulation 
is contained in either the Equipment input deck or the Weapon Effects input 
deck. Table 6-4 presents the variables in the Equipment input deck while 
Table 6-5 presents the variables in the Weapon Effects input deck. 


The variables of Table 6-4 relate primarily to weapon or vehicular 
parameters such as rate-of-fire, rate-of-movement, fuel consumption and 
capacity, effective firing range, and traditional targets. The variables 
of Table 6-5 relate to the lethality of the various weapons for all classes 
of targets against which they might be employed. This deck also includes 
data reflecting delivery dispersion errors for fire support weapons (i.e., 


artillery). 


Although the number of individual variables in tne Weapon Effects input 
deck is not large (eight), the total number of data entries for this deck 
can be very large. For example, the IFNTB(I,J) array currently has over 
700 entries while the EFFDAT(ICOEF,J) array has about 250 entries. Again, 
the user is urged to review the variable definitions of Appendix A and the 
appropriate portions of Section 4 (as noted in Table 6-1) to gain a clear 
understanding of the model's usage of these input variables. This knowledge 
is essential if a user is to attempt data base modifications. 


6.1.1.3 Unit Operations Data 


As indicated in Table 6-1, several of the 29 input decks have been 
grouped under the heading of Unit Operations Data. It is the data in these 
decks that allow each unit's equipments (notably the weapons) to be operated 
in different fashions in response to variations in the unit's tactical 
situation. 


Primarily, it is changes in a unit's "operational state” that cause 
the unit to change the manner in which it uses its equipment. The input 
data that defines how a unit's equipment is to be used as a function of the 
unit's operational state is contained in the decks read in by subroutines 
MUINP and FSINP. Tables 6-6 and 6-7 present the variables in these two 
input decks. As noted in Table 6-1, certain portions of Section 4 contain 
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important information relating to these input data arrays. In addition, 
several of the “term” definitions of Section 3 will provide added insight 
as to the model's usage of this data. Specifically, the appropriate para- 
graphs of Section 3 to review are Sections 3.101, 3.85, 3.12, 3.71, 3.111, 
3.105, 3.54, 3.21, 3.17, and 3.29. Because of the critical nature of these 
data arrays (particularly those in the Unit Operational States input deck), 
it is important that they be constructed or modified with great care. 


The input data variables contained in the Unit OP State Decision and the 
Unit Movement Control input decks (see Tables 6-8 and 6-9) provide the input 
data that control automatic changes in a unit's operational state and move- 
ment code as the tactical situation changes. In the original MAFIA V model, 
these tables played a very important role; however, in the current CATTS 
model, they play a relatively minor role. This is because, as a general 
rule, changes to a unit's operational state and movement code are inter- 
actively controlled by the simulator's controllers via the Maneuver Control 
and Fire Control Menus. Nonetheless, selected entries in these tables 
may be used to relieve controller workload for those tactical situations 
wherein a unit would almost invariably change from operational state A to 
operational state B whenever condition C occurred. A similar rationale 
exists for tne entry of data to effect changes in a unit's movement code. 
As noted in Table 6-1, certain portions of Section 4 contain information 
relating to these input data decks. In addition, Sections 3.27, 3.88, 3.89 
and 3.145 contain other information relating to the definitions of specific 
terms. Finally, Section 5.9.3 presents a detailed explanation of the model's 


usage of the data contained in these input decks. 


A discussion of the data variables contained in the Preplanned Mission 
Control input deck (see Table 6-10) should start by introducing the concept 
of predefined and prescheduled “events". In the CATTS model, an event is 
defined to mean that some change in the status of something is to occur at 
some future time. The list of allowable event types, any of which can be 
either predefined or prescheduled, is presented in Table 6-11. For example, 
a weather event can be constructed (via specific input data) that causes 
the weather to change from, say, clear weather to heavy rain. Now, the 
difference between a prescneduled and a predefined specific weather event 
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Table 6-I1. Event Types 


No. Type 

| Weatner 

2 Resupply 

3 Control Measures 

4 Split nit (Create DLIC's) 


Generate Alert Messaae 


6 Change Unit Location 
/ Deactivate Units 

8 Air Mission 

y Ground Maneuver 

10 Ground Fire Mission 
1] Unused 

12 Unused 

13 Unused 

14 Air Defense Mission 
15 Preplanned Mission 
16 Task Organization 
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is explained as follows. Suppose, for example, that the controller wishes 
to have the weather change from clear to heavy rain at a specific hour 
during the simulation exercise. In this case, it would be necessary for 
the specific input data to be defined and "tagged" with the desired clock 
time for the event to occur. This data is then input to the data base 
(via the procedures outlined in Section 5.9.2) and is stored in the pre- 
scheduled events file. Then, without further action from the controller, 
the event will occur when the proper time is reached. A predefined weather 
event that called for a weather change from clear to heavy rain would have 
the same specific input data as a prescheduled event except that it does 
not have a time "tag". Also, it is not stored in the prescheduled event 
file but is instead input via the Preplanned Mission Control input deck. 
This differentiation allows the controller to access the event (through 
the preplanned mission command and contro] menu) and causes the event to 
occur at any time in the simulation exercise that the controller desires. 


Section 5.9.2 provides the detailed procedures for defining the format and 


content of each of the allowable event types. Several examples of selected 
events are also presented. The tiain points to remember are as follows: 

Predefined events are not time tagged but can be initialed by the controller 
at any time. Prescheduled events must be time tagged and will occur at that 


time without further controller action. Predefined events are input via 
entries in the Preplanned Mission Control input deck. Prescheduled events 
are input via other means and stored in the Prescheduled Events File as 
described in Section 5.9.2. Predefined events will occur only if the con- 
troller takes positive action to initiate tnem. Prescheduled events, once 
lefined, cannot be stopped from occurring. 


The input data variables contained in the Unit Suppression Control 
input deck (see Table 6-12) provides the input data that controls the degree 
of suppression occurring in a unit as the tactical situation varies. 
Sections 4.13 and 4.23 provide detailed information for the variables 
ISSLCT(I) and SIGTAB(I,J), respectively. Sections 3.133 and 3.134 provide 
definitions of suppression criteria and suppression effects, respectively. 
The user is advised to review these sections before attempting to develop 
or modify input data for the Unit Suppression Control input deck. 
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6.1.1.4 Task Organization Data 


The input variables contained in the Operational Group input data 
deck (see Table 6-13) consist of the input data necessary to specify the 
activities of operational groups. The definition of an operational group 
as a collection of units acting in concert is explained in detail in 
Sections 3.99, 3.100, and 3.141. Added information relative to the develop- 
ment of input data for operational group movement data is presented in 
Section 4.20. 


The particular variables IDWENG, FECFAC, HLFRN, and IREENG do not play 
as prominent a role in the CATTS model as they did in the original MAFIA V 
nodel. The reason for this is that a large portion of the model's automatic 
engagement logic (the portion where these variables are used) is by-passed 
in the current CATTS scenario. This by-passing results from the fact that 
the variables NGARNG and MFIGHT (see Unit Type input deck) are currently 
initialized to zero. Nonetheless, a specific value must be input for the 
aforementioned four variables (a 1 is acceptable) for successful model 
initialization. Operational groups may be formed via data entries in the 
Operational Group input deck or through use of the Task Organization menu 
from the controller‘s console at any time during the simulation exercise. 
[nese latter procedures are outlined in the CATTS Operator's Manual. 


The single variable noted in Table 6-14 as betonging to the Initial 
Engagements input deck is a holdover from the original MAFIA V model. In 
the CATTS model, it must be initialized to zero to successfully initialize 
the model. 


6.1.1.5 Target Acquisition Data 


The data included in the Sensors, Visual Detection, Aural Detection, 
Unattended Ground Sensors (UGS), and Ground Radar input decks (see Table 
6-15) consists primarily of that data necessary to define the performance 
parameters of the various types of target acquisition devices as well as 
selected data related to the operational usage of the devices. Several 
term definitions that present information relevant to target acquisition 
sensors are presented in Sections 3.67, 3.68, 3.146, and 3.147. With the 
exception of the UGS devices, the sensors are defined as a particular 
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equipment type and are associated with selected units in the same manner 
as are trucks, for example. The UGS, on the other hand, are associated 
with the area of operations in a global sense, thus, it is necessary that 
the UGS field coordinates be specified via the input variables UASFX and 
UASFY. 


The data included in the Target Acquisition input deck (see Table 
6-16) is another holdover from MAFIA V. It is not used at all in CATTS 
and all reference to it should be eliminated from the current CATTS model. 
However, since it has not been eliminated, as yet, dummy input data must 
be input via this input deck for successful model initialization. 


6.1.1.6 Obstacle/Control Measure Data 


Tne data input via the Mine Obstacle Fortification input deck generally 
relates to the size and location of the allowable types of obstacles. In 
addition, as noted in Table 6-17, the specification of several variables 
that are actually input by subroutine INPUT from the Namelist input deck is 
required. Although really part of another input deck they are collected in 
Table 6-17 since they relate to the model's operations with respect to unit's 
encounters with obstacles. The variable definitions of Appendix A provide 
information of value to the analyst when constructing or adding to the CATTS 
data base. See also, Sections 3.94, 3.95, 3.96, and 3.97. The Control Mea- 
sures input deck contains the variables required to define the model's con- 
trol measures (see Table 6-18). The primary data in this deck is the variable 
ICM(J,ICM). It is this variable that specifies the type of control measure 
(point, line, or area) and the class within the given type. It also defines 
the” locktion in térms of X% coomMnates Fas many points as are required 
to define the extent of the control measure. Section 4.3 and Sections 3.38, 
3.39, and 3.40 should be reviewed for added information as to the precise 
format and content of this input data deck. 


The development of a set of NAMELIST input for minefields can be 
accomplished by several methods. The only complication involved is that 
some of the variables are packed, yet Xerox NAMELIST accepts only decimal 
integer representations. This leaves the user the alternatives of 
performing some tedious manual calculations, or of exploiting some features 
of the CATTS model to automate these calculations. 
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Manual data packing calculations are performed as follows: 


n 
The desired value V = %. P.D: 
i=] 


where 
n = number of packed quantities to store l<n<4 


S 
" 


decimal integer value to be stored 


=) 
iT} 


displacement value 


The proper displacement value depends on where P. is to te stored. If we 
number the four bytes of a computer word as 1 to 4 from left to right, and 
the two halfwords as 1 to 2 left to right, then the value of D: is given 
as follows: 


P. Stored as Value of oF 


Byte 1 16777216 
Byte 2 65536 


Byte 3 256 
Byte 4 ] 
Halfword 1 65536 
Halfword 2 ] 


The only problems with performing the packing calculations manually are 
the time consumed and the risk of making a mistake and entering an 
incorrect value which could degrade simulation results, yet be difficult 
to detect. The user is reminded that the maximum value which may be 
stored in a byte is 255; in a halfword, 32767. 


Automated packing of minefield data will be performed automatically 
by the math model input routine MINEFLDS. This routine will print out 
the packed data in NAMELIST-readable format if the user-set input flag 
IPBSFLAG is set such that 128 < IOBSFLAG < 255. Thus, a minefield input 
deck can be prepared in the normal way; the model run with IOBSFLAG = 128 
and the proper switches set to cause reading of these decks (it is not 
necessary to perform an exercise, merely to allow the model to read the 
input decks and complete initialization as described in the Data Base 
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input decks and complete initialization as described in the Data Base 
Operations Manual) and the necessary packed values extracted from the 
data printout created. 


6.1.1.7 LOC Data 


The data input from the Road and Bridge input data decks by Subroutine 
ROADINP contains the input variables of Table 6-19. For the case of roads, 
this data includes the road type, road width, and sufficient X-Y coordinate 
sets to define the desired extent of the road. The bridge input data 
includes the bridge type, bridge width, and the X-Y coordinates of its 
end points. See also Sections 3.22, 3.23, 3.120, 3.121, and 3.122 for 
additional information. 


6.1.1.8 Display - - Alphanumeric Data 


The input data contained in the input data decks of this grouping 
(see Table 6-1) provides that data needed by some of the menus presented 
on the video monitor display. The variables are identified in Tables 6-20 
through 6-22. As a general rule, the only use made of this data is to cause 
alphanumeric names to be written out in various portions of selected menus. 
Several paragraphs of Section 3 provide additional information as to the 
input of and the use of this data. Specifically, see Sections 3.56, 3.82, 
and 3.92. 


6.1.1.9 Miscellaneous Data 


The input data decks in this grouping include the Miscellaneous 
Variable, the Miscellaneous, and the Namelist input decks, see Table 6-23. 
This data, read in by Subroutine INPUT, consists of a wide variety of input 
data classes. Appendix A provides a definition of each of the listed vari- 
ables. The variables of Table 6-23 are in some cases, bookkeeping type 
variables, others are for debug printout control, while still others are 
required for combat simulation operations by the math model. For this 
latter class, an attempt has been made to identify, in the table, the input 
data deck with which the variable is most-closely associated. For example, 
the variable BEYOND is associated with the .nput data deck read in by Sub- 
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routine OBFMINP. This is because the input data for BEYOND is used by the 
math model's obstacle submodule. Other examples of this nature include 
DISMAX, DIMTBFI, and so forth. The rationale for the use of this namelist 
data input technique is well documented in Section 4 of the CATTS Data 


Base/Operations Manual. 

Tables 6-24 and 6-25 each present a list of variables that are subsets 
of the variables of Table 6-23. Table 6-24 includes those variables that 
are compiled in the Miscellaneous Variable Input deck while Table 6-25 
includes those variables that are compiled in the Namelist Input deck. 
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6.1.2 Data Base Input Data Deck Sequence 


A detailed description of the procedures for inputting the data base 
scenario data contained in the 29 input data decks discussed in the previous 
section, as well as the five separate files containing terrain data and 
the one prescheduled events data file, is presented in Section 5.7 of this 
User's Manual. 


Tne order in which the 29 input data decks must be sequenced is shown 
in Table 6-26. It should pe noted that this sequence is not the same as 
that shown in Table 6-1. The sequence and grouping of input decks, as in 
Table 6-1, was done merely to facilitate the discussion of Section 6.1.1. 


6.1.3 Data Base Modifications 


The previous section has presented a series of detailed tables (one for 
each input deck) identifying each of the individual input variables that 
must be defined for the specific class of data input via the particular 
input deck. As previously noted, there are in excess of 330 different 
variables and since many of them are multi-dimensioned there are about 
20,000 individual data values. This total of 20,000 results from the fact 
that the current CATTS scenario contains 99 units, 80 equipment classes, 
and 11 unit types as well as several other multi-dimensioned elements. 


The nature of the input data format structure and the input data disk 
file storage design are such that minor modifications (replacements, inser- 
tions, and/or deletions) to the data base would require that the entire 
input data deck of over 4000 cards be "read in" every time a change was 
made. Since this is quite costly in terms of both time and computer usage 
a specialized data base editor program was developed. This special editor 
allows data base changes to be made with a minimum of both analyst effort 
and computer usage. A description of its functioning and procedures for its 
use are presented in Section 4.2.1 of the CATTS Data Base/Operations Manual. 
In addition, a second even more specialized editor is available for the 
purpose of making changes to the extensive weapon effects input data base. 
This editor is described in Section 4.2.2 of the above reference. The basic 
advantage of both of these editors is that each allows modifications to be 
made to the data base by reading in only as many data cards as are required 
to define the new data instead of having to read in the entire data deck of 
over 4000 input data cards. 
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Table 6-26. Input Data Deck Sequence 


Miscellaneous Variable Input Deck 
Equipment Input Deck 

Ammunition Name Input Deck 

Sensors Input Deck 

Visual Detection Input Deck 

Aural Detection Input Deck 
Unattended Ground Sensors Input Deck 
Ground Radar Input Deck 

Unit Type Input Deck 

Target Acquisition Input Deck 
Weapon Effects Input Deck 

Unit Description Input Deck 
Operational Group Input Deck 
Higher & Adjacent Units Input Deck 
Unit Menu List Input Deck 

Initial Engagements Input Deck 
Unit OP State Decision Input Deck 
Operational State Name Input Deck 
Unit Operational States Input Deck 
Unit Movement Control Input Deck 
Fire Support Control Input Deck 
Unit Suppression Control Input Deck 
Control Measures Input Deck . 


Mine Obstacles Fortifications Input Deck 


Road Input Deck 

Bridge Input Deck 

Preplanned Mission Control Input Deck 
Miscellaneous Input Deck 

Namelist Input Deck 
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6.2 DATA BASE MODIFICATION PROCEDURE AND EXAMPLES 


6.2.1 Nine Basic Steps for Changing the Data Base 
There are nine (9) basic steps associated with changing the CATTS 

simulation via the CATTS data base. These 9 steps are depicted in Figure 
6-1 and represent a procedure whereby someone fairly new to CATTS will be 
able to solve the problem of identifying the proper variables and how they 
are used (and where the places are on the data base file that correlate 
with the variables) in order to implement desired changes in tne CATTS 
simulation via changes in the data base are presented in Section 6.2.2, 


Step 1: Need for change identified. 


Tnis includes simple items like discovering that a unit has an 
incorrect number of personnel, or the controllers requesting a con- 
trol measure be moved. Also included are more complex things like 
the Army wanting to update all red units and equipments to reflect 
more realistic and current TOE (Table of Organization and Equipment) 
information. 

Step 2: Identify the variables that must be changed (and how they 
are used). 

For those new to the model, this is by far the most difficult 
step. Changing the data to cause changes in the simulation is compli- 
cated and a bit tricky, and without a certain amount of knowledge and 
training, it simply can't be done. A certain minimal knowledge of 
the CATTS math model operation is therefore necessary before one can 


begin changing data. 


Considering that a large part of the CATTS data base is used in 
a very straightforward manner (e.g., data on how many men a unit has, 
how much and what kind of equipment each unit has, etc.), the user is 
presented with the problem of locating all of the places on the data 
base file that need to be changed. Several places to begin the search 
are available; one is Table 6-1 of this User's Manual, while others 
are the tables of contents of the User's Manual and the Programming 
Report. Also, Table 6-27 can be used in conjunction with programs 
SORT and LIST described in Appendix A of this User's Manual. Looking 
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through these sources and knowing what type of change is desired 
should yield at least a beginning list of variables. The data base 

is organized into input decks which are grouped in a logical manner. 
Once the input deck which contains some related variables is located, 
all other variables in the deck should be examined for their rele- 
vancy and the variables in the related decks under an underlined 
heading (shown in Table 6-1) should also be examined by looking up 
definitions in Appendix A. The submodules that perform the operations 
can be found by examining the table of contents of Section 5 or by 
using the subroutine names associated with the definitions in Sections 
3 and 4 and Table 5-1 (Math Model Subroutine Index) to locate the 
section where the submodule is discussed. In addition, Section 5 of 
the Programming Report contains a list of variables input and output 
by each submodule. Using these sources, the user can locate all the 
variables required for a change (with the possible exception of some 
indices - see step 3 below). By reading the definitions in Appendix 

A and the appropriate parts of Section 5, the user should be able to 
understand the variables and how tney are used. 


Step 3: Locate the variables on the data base file. 


Table 3-1 in the Data Base/Operations Manual shows the 


location of all the input variables on the data base file (Example 
NBIG, NGOLD - see Table 1-1 in Data Base/Operations Manual for the 
complete list of CATTS data files). The user must always check the 
3 miscellaneous data files listed at the end of Table 6-1 in the 
User's Manual for variables related to the current change because 
this is where many of the indices are set. Also, most of the vari- 
ables which control the debug printout are set in the NAMELIST deck, 
and these can be quite useful while making a change. The value of a 
variable set in the NAMELIST deck will override the value put in for 
it in any of the decks which precede this NAMELIST deck. 


This process of locating the variables also allows the user to 
examine the current values input for the variables he is interested 
in. These current values can often be the best guide as to what 
data is needed. 
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Since the decks on the input file contain variables which are 
logically grouped, once the user has found the appropriate deck and 
checked the 3 miscellaneous deck, the complete list of variables 
needed for a change will have been compiled. The only problem with 
this logic is that some changes cause other changes (for example, it 
does no good to add a new equipment to the data base unless the unit 
data is changed to reflect the new TOE). 


Step 4: Create forms to gather data with. 


If only a small change is to be made, this step may be omitted. 
For any change that requires any volume of data at all, this step is 
very important. Use the forms supplied with’ the CATTS System or make 
new ones, whichever seems best. (The complete set of forms TRW used 
to gather the data to create the CATTS data base has been supplied to 
Ft. Leavenworth personnel). Figures 6-2 and 6-3 are samples of these 
forms; one for unit data (Figure 6-2) and the other for equipment data 
(Figure 6-3). 


Step 5: Gather data. 


Resourcefulness is what is required in finding the data and in 
inventing the data that cannot be found. Appendix C of the Data 
Base/Operations Manual and Section 5.7.1 of this manual shows the 
sources of the original CATTS data base. One source now available 
to the user that is not shown in Appendix C of the Data Base/Qperations 
Manual is the current CATTS data base. If the user is unsure of how 
data is used or what the numbers should be, check the current numbers 
since they are what makes the model operate the way it does now. 


Steps 6 & 7: Punch cards and input to model. 
Section 4 of the Data Base/Operations Manual covers the exact 


procedures for editing the data base and initializing the model so 
that the new data can be read in. 


Step 8: Test. 


Run test.scenarios and see if the desired change was accomplished. 
Use the graphics, special status reports, and the 15-minute status 
to check the change. Visually examine a printout of the data base to 
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@ 
insure that the proper data was changed. Make a test by inputting 
the proper event notices in the namelist portion of the run deck 
(this makes a test exactly repeatable). Run the compare program 


shown in Section 5.0 of the Data Base/Operations Manual. Repunch 
cards and input to the model and retest when errors are found. 


Step 9: Fill out configuration control forms. 


Once the final data for the cnange has been arrived at through 
testing, changing, and retesting, fill out the data base configura- 
tion control forms. (See Software Configuration Management Plan, 

7 March 1975.) It is imperative that the user maintain configuration 
control. 


6.2.2 Specific Examples 


Examples of applications of the procedure described in Section 6.2.1 
to effect changes in the CATTS simulation via changes in the data base are 
presented in this section. These examples include: 


@ How to input the data that defines a unit. 

e How to implement a new unit type. 

e How to implement a new equipment type. 

e How to change the weapon effects data. 

@ How to change the modes of equipment operation. 


These examples will lead to discussions of all the data with the 
exception of the terrain, vegetation, and soil files, and the most trivial 
of data on the scenaric data file (e.g., NBIG). 


6.2.2.1 How to Input the Data that Defines a Unit 
Once the need for a new unit has been identified, the search begins 
for the variables. On Table 6-1 of this User's Manual, the first 2 decks 
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a type already in the data base. Looking further down Table 6-1, other 
items that should be investigated are: Unit Menu List (23) and Higher 
and Adjacent Units (24). And last, but not least, the user must always 
check the miscellaneous decks (27, 28, and 29) as this is where indices 
are set, debug printout is controlled (useful when making a change), and 
miscellaneous variables (some of which could be included in the various 
decks) are located. This would yield a list of all the variables that 
might need to be changed to incorporate a new unit into the data base. 


Another aid would be to look up the definition of “unit" in Section 
3.148 of the User's Manual. Located here are almost all the variables 
directly associated with units, the exception being some of the indices 
in the miscellaneous data decks. 


The user can also use the SORT and LIST programs described in 
Appendix A of the User's Manual. The index IU selected from Table 6-27 
is used to search the input deck discussed in Appendix A. Table 6-28 
shows the variables which are printed out as a result of this search. 
This table includes all of the variables (with 5 exceptions) which could 
have been found using any of the three methods suggested. The other five 
variables are ones which might have to change, and were located by search- 
ing the 3 miscellaneous data decks. The user should become familiar with 
the data in these 3 miscellaneous decks after a few changes in the data 
base. The five variables are: 

NFDU Number of first dummy unit. (Dummy units 

include air units used to index air unit 


arrays). Air unit index for unit I is 
I + 1 - NFDU. 


NLDU Number of last dummy unit. (Dummy units 
include air units.) NLDU minus NFDU must 
be less than 10. 


NRUP1 Number of first blue unit (>NLDU). 

NUNIT Total number of units (red and blue). Must 
be =< 99. 

NRU Number of red units must precede blue units. 


Some logic must also be used for other items that might change 
because of a new unit. For example, if several units are added, this 
may effect tasking organization, and the variables in decks 11 and 12 
should be checked to see if there need to be changes. Qne might suspect 
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Table 6-27. Indices of Input Variables 
(Only input indices are shown) 

Index Description 

IAMMO ammo type (1-80) 

IBD fire support band number (1-4) 

IBDS fire support target band set (1-9) 

IBR bridge number (1-16) 

IBRT bridge type (1-2) 

ICM control measure (1-100) 

ICMT control measure class (1-6) 

ICOEF weapon effects coefficient set (1-315) 

IDF arty dispersion function (1-10) 

IEQ equipment type (1-80) 

IGS sensor index (1-14) 

IGSR radar type (1-6) 

IMODE equipment mode (1-8) 

INMODE number of entries which can select a 
mode vector 

IOBS obstacle number (1-50) 

IOBST obstacle type (1-10) 

10PG op group (1-20) 

IPPM preplanned mission number (1-10) 

IPVC personnel vulnerability class 

IRAFT raft for units (was done for test purposes. 
Don't use. ) 

IRD road number (1-50) 

IRDSG road segment (1-500) 

IRDT road type (1-3) 

ISOIL soil type (1-15) 

ITDGB terrain data grid block (1-64) 

IU unit (1-99) 

IUCLS unit class (1-11) 

IUGS UGS field number (1-10) 

IUGST UGS type (1-10) 

IUT unit type (1-20) 

IVEG vegetation class (1-16) 

IVPOL vegetation polygon (1-225) 


IWC weather class (1-8) 
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that units might be specifically mentioned in the decks under the UNIT 
OPERATIONS DATA heading. Though currently (with the possible exception 
of the preplanned mission deck) no units are specifically mentioned, they 
can be in decks 6, 7, 8, and 9. 


Since units are used in some way by each CATTS module, the user can't 
really pick out one subsection of Section 5 to read to tell how the vari- 
ables are used. However, there are many related terms in Sections 3 and 
4 of the User's Manual. Listed below are some that the user could pick 
by looking at the table of contents for Section 3: 


Section 3.10 Air Unit 
b .18 Basic Load 
.19 Battalion 
.30 Color 
.31 Combat Unit 
.32 Combat Support Unit 
.33 Combat Service Support Unit 
-35 Command Post 
.36 Company 
-42 Current Load 
.56 Fake Unit 
.89 Movement Code (Unit) 
.92 Next Higher Command 
.104 Personnel 
.106 Platoon 
.145 Travel Code 
148 Unit 
.149 Unit Class 
.150 Unit Location 
.151 Unit Size 
.152 Unit Status 
.153 Unit Type 


WW WW WW W WW WH WW WD WW WWW WW Ww 


If the user wishes to follow a particular variable to determine its 
use, he should look up the variable in the Super Index. This lists all 
the subroutines where the variable is used. Then Table 5-1 in the User's 
Manual will show where these subroutine operations are discussed in the 
User's Manual and Table 5-1 in the Programming Report shows where each 
subroutine is discussed in the Programming Report. 


Once all the variables have been identified and a basic understand- 
ing of what they do is reached, it is a very straightforward matter to 
complete the ramining step using the instructions and the manuals refer- 
enced in the general examples. 
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6.2.2.2 How to Implement a New Unit Type 

Once the need is identified, we see from Table 6-1 that most of the 
variables needed for a new unit type are in the unit type deck described 
on page 52 of the Data Base/Operations Manual. The definition of “unit 
type" in Section 3.153 of the User's Manual yields the complete list, with 
the exception of the miscellaneous deck variables. The SORT and LIST 
programs described in Appendix A of the User's Manual are run using the 
index IUT selected from Table 6-27 to yield the list of variables shown 
in Table 6-29. 


Using the Data Base/Operations Manual, all of the variables except 
five (5) are discovered to be in the UNIT TYPE deck. These five are: 


ADTPR Fraction of unit type IUNTYPE, red (ICOLOR = 1) 
or blue (ICOLOR = 2), can be expected to be 
acquired at any given time due to aerial sur- 
veillance; (K = 1) target unit in engagement 
region, (K = 2) target unit outside engagement 
region. (1<=IUNTYP<= 20) 


DISMAX The maximum distance (in meters) for the line 
of sight calculations for unit type IUT. 
(1<= JUT <= 20) 


HUN Height (in meters) of a single element of a 
unit of unit type I - for line of sight cal- 
culations. (1<=IUT<= 20) 


IAIRVUL An indicator describing the vulnerability of 
unit type IUT to air ordnance. (1<=I1UT<= 20) 
0 = not used 
1] = not armored 
2 = light armored 
3 = heavily armored 
WUN Width (in meters) of a single element of a 


unit of type IUT for line of sight calcula- 
tions. (1<=IUT<=20) 
Since the definition for ADTPR talks about target acquisition, the 
TARGET ACQUISITION deck is checked in the Data Base/Operations Manual, 
and this reveals not only that ADTPR is read in via this deck, but that 
the value is not used by CATTS. Makes data collection very easy for 
ADTPR. The only places left to look for the others are the 3 miscellaneous 
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decks shown on Table 6-1. DISMAX and IAIRVUL are discovered to be in the 
namelist portion of the data file. Two variables are discovered in the 
miscellaneous variable deck at the front of the data file which might need 
to be changed when adding a unit type. These are NPRWT, the maximum 
number of priority weapon types allowed for a particular unit type, and 
NUNTYP, the total number of unit types. No other variables of interest 
for unit type are discovered by searching the namelist portion of the 

data base file. However, neither HUN nor WUN appears in any of the places 
searched so far. A check of Appendix A of the Data Base/Operations Manual 
shows that the variables are both eligible to be input via the namelist 
portion of the data base. Checking Super Index, the variables are shown 
in CMAIN and LOSCOMP. Checking CMAIN, the variables are shown to be set 
via a data statement on line 66. Thus, the logical way to set these vari- 
ables is via the namelist with the data statement as a backup default value. 


Looking up any variable in Super Index yields all the names of the 
Subroutines where the variable is used. These subroutines and the sections 
which discuss their functioning can then be looked up using Table 5-1 in 
this manual and Table 5-1 in the Programming Report. Once these sections 
are read, and a basic understanding of each variable is reached, the only 
difficult part remaining is gathering the data. Inputting the data is 


explained in the Data Base/Operations Manual, and the configuration control 


is covered by the Software Configuration Management Plan of 7 March 1975, 
as shown in the general steps at the beginning of this section. 


6.2.2.3 How to Implement a New Equipment Type 

Table 6-1 of this User's Manual shows the equipment data deck to be 
discussed on page 17 of the Data Base/Operations Manual. Also shown as 
equipment data is the weapon effects deck. This data must indeed be added 
if the new equipment is a weapon, but will be covered in the next example. 
Further examination of Table 6-1 indicates that if the new equipment is a 
sensor, the appropriate decks under the TARGET ACQUISITION DATA heading 
should be examined for relevant variables. Also, it is logical that 
adding a new equipment will do little good if the Unit Data is not changed 
so that the proper units and unit types have the equipment, so the variables 
in these two decks should be checked for relevancy (it turns out that 


Page 6-82 


equipment manning is controlled in the UNIT TYPE deck). Also, if the new 
equipment is a weapon, obviously the variables in the Ammunition Name Deck 
should be checked. 


The Equipment type discussion in Section 3.54 and the SORT/LIST pro- 
grams described in Appendix A give a complete list of the important equip- 
ment variables. This list is shown as Table 6-30 which is a sort on index 
IEQ (from Table 6-27). 


Tables 6-31 and 6-32 are the result of a SORT/LIST on two sensor 
related indices selected from Table 6-27. These variables should obviously 
be looked at if the new equipment is a sensor. 


The variables listed in Table 6-30 all appear in the EQUIPMENT INPUT 
Deck or in the namelist portion of the data base file with the exception 
of IECTH. Since it is nowhere to be found, Super Index is consulted, 
and it shows IECTH to be used in FORMAIM and FIRAGEN. Upon checking, 
IECTH is discovered to be set by a data statement in line 136 of Subroutine 
FORMAIN. Appendix A of the Data Base/Operations Manual shows that the 
variable IECTH can be input via the namelist portion of the data base file, 
which is what should be done if a change is desired. The data statement 
in FORMAIN can then serve as a default value. As recommended, one final 
check of the namelist portion and the other 2 miscellaneous decks reveals 
4 other variables that might need change as the result of a new equipment. 
These are: 


NEQUIP total # of equipment types. 

NMODES maximum number of modes of operation assigned 
for any equipment class. 

IPDFNA degradation used for manning priority of a 
vehicle. 

IPDSFW degradation used for manning a support fire 
weapon. 


All these variables allow any type of ground equipment or air equip- 
ment to be added (both the ground and air definition is included with each 
variable). Shown in Table 6-33 are all the variables with only their air 
equipment definitions. 
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Table 6-33. Air Equipment Variables 


IEQCOD(IEQ) = -1 = > Equipment IEQ is an aircraft 
-2 = > Equipment IEQ is an airborne weapon 
-3 = > Equipment IEQ is an airborne sensor 


Assume equipment IAC is an aircraft; i.e., IEQCOD(IAC) = -1. 


ROME(IAC,1)) = Maximum load aircraft can carry (pounds) at best 
modeled pressure density (PDBEST) 

ROME(IAC,2) = Maximum altitude of aircraft (meters) 

ROME(IAC,3) = Minimum speed of aircraft (meters/minute) 

ROME(IAC,4) = Cruise speed of aircraft (meters/minute) 

ROME(IAC,5) = Maximum. speed of aircraft (meters/minute) 

ROME(IAC,6) = Maximum load aircraft can carry (pounds) at worst 


modeled pressure density (PDWORST) 


Note: The correct negative value for ROME(IAC,6) will insure 
that an aircraft cannot fly at pressure densities below 
its capability. 


ROME(IAC,7) = Poorest meteorological visibility in which aircraft 
can continue its mission (meters) 

ROME(IAC,8) = Maximum acceleration (meters /minute®) 

ROFE(IAC,1) = Fuel expenditure for losing altitude (1b/meter of 
altitude) 

ROFE(IAC,2) = Same for gaining altitude 

ROFE(IAC,3) = Fuel expenditure at minimum speed, minimum load, 
best pressure density (1b/min) 

ROFE(IAC,4) = Same at cruise speed 

ROFE(IAC,5) = Same at maximum speed 


ROFE(IAC,6) = Fuel expenditure rate at maximum load at standard 
. uel expenditure rate at minimum load \pressure density 
- Fuel expenditure rate at worst pressure density 
ROFE(IAC,7) = uel expenditure rate at best pressure density 


ROFE(IAC,8) = Climb rate maximum (meters/minute) 
IAMTE(IAC,1) = Takeoff delay time for this aircraft (minutes) 
IAMTE(IAC,2) = Landing delay time for this aircraft (minutes) 


Fuel capacity of aircraft (pounds) 


EQCAPAC( IAC) 


Then 


Only filled 
for 


Table 6-33. 


IPVCE(IEQ,J) 


IMINRE(IEQ) 


IMAXRE(1EQ,1) 


ROME (1EQ,1) 
ROME(IEQ,2) 
ROME (1EQ,3) 
ROME (1EQ,4) 
ROME (1EQ,5) 


ROME ( IEQ,6) 
ROME (IEQ,7) 


IEQCOD(IEQ) = -2] ROME(IEQ,8) 


Assume IEQCOD(IEQ) 


Then 


ROFE(IEQ,1) 


ROFE(IEQ,2) 
ROFE(IEQ,3) 


ROFE(1EQ,4) 


ROFE(IEQ,5) 
ROFE(IEQ,6) 
ROFE(IEQ,7) 
ROFE(1EQ,8) 
IAMTE(IEQ,1) 
IAMTE(1EQ,2) 


-2 or -3. 
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Air Equipment Variables (Continued) 


Assume equipment IEQ is an air equipment other than an aircraft; i.e., 
IEQCOD(IEQ) = 


Equipment number of the Jth allowable aircraft type 
on which IEQ may be used. (Hence, a maximum of 
eight aircraft per equipment type.) The first zero 
encountered = > no other allowable aircraft 


Minimum range at which equipment may be used 
Maximum range at which equipment may be used 


Weight of eauipment (pounds) including standard 
ammunition load 


Minimum aircraft 
equipment can be 


speed (meters/minute) at which 
used 


Maximum speed at which equipment can be used 
(meters/minute) 


Minimum altitude at which equipment can be used 


(meters ) 


Maximum altitude at which equipment can be used 


(meters ) 

Road crater radius for road type 1 (meters) 
Road crater radius for road type 2 (meters 
Road crater radius for road type 3 (meters) 


-2, that equipment IEQ is an air-delivered weapon. 


Fraction of personnel in personnel vulnerability 
Class 1 (standing) and within target area who are 
killed by this equipment 


Same for personnel vulnerability Class 2 (crouching) 
Same for personnel vulnerability Class 3 (prone) 


Fraction of equipment with IEQCLS = 1 and within 
target area which is damaged by this equipment 


Same for IEQCLS = 2 
Same for IEQCLS = 3 
Same for IEQCLS = 4 
Same for IEQCLS = 5 


Number of ammunition types for this equipment, if any 


Number of rounds in a standard load of that ammunition 
type 
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Table 6-33. Air Equipment Variables (Continued) 
IAMTE(IEQ,3) = Rate of fire of this equipment (rounds/minute) 
IAMTE(1EQ,4) = Number of drops per pass (applies to bombs) 


IAMTE(IEQ,5) = Distance between drops (meters) 
Assume IEQ is a ground equipment type - - that is, IEQCOD(IEQ)=0. Then 


IEQCLS(IEQ) = J = IEQ is in equipment vulnerability Class J with 
respect to air-delivered weapons, 1<J<5 


Assume IEQ is an air-delivered weapon - - that is, IEQCOD(IEQ) = -2. Then 


IEQCLS(IEQ) = 1 = © IEQ is a 250-1b low-drag bomb 
= 2 = > IE£Q is a 500-1b low-drag bomb 
= 3 = > IEQ is a 750-1b low-drag bomb 
= 4 = IEQ is a 1000-1b low-drag bomb 
= § => IE€Q is a 2000-1b low-drag bomb 
= 6 = > IEQ is a 250-1b high-drag bomb 
= 7 = > IEQ is a 500-1b high-drag bomb 
= 8 = > IEQ is a 750-1b high-drag bomb 
= 9 ===> IEQ is a Maverick 
= 10 = IEQ is a Shrike 
= 11 => IEQ is 2.75 rockets 
= 12 = > IEQ is a 20-mm cannon 
= 13 = > IEQ is a CBU-2 
= 14 = > IEQ is a Rockeye 
= 15 = > IEQ is a Napalm 


Air to Ground Sensor Data (For Air Sensors - IEQCOD(IEQ) = -3) 


IEQCOD( IEQ) -3+ Equipment IEQ is an Airborne sensor 


IPVCE(icQ,J) = Aircraft Equipment Number of tne Jt” (1< <8) 
allowable aircraft type on which air sensor (IEQ) 
may be used. The first zero encounters implies 
that no other aircraft can carry this sensor 


Minimum range at which sensor may be used 


IMINRE(IEQ) 
IMAXRE(IEQ,1) 
ROME (1EQ,1) 


Maximum range at which sensor may be used 
Weight of sensor in pounds 
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Table 6-33. Air Equipment Variables (Continued) 

ROME(IEQ,2) = Minimum aircraft speed (meters/minute) at which the 
sensor can be used 

ROME(IEQ,3) = Maximum aircraft speed (meters/minute) at which the 
sensor can be used 

ROME(IEQ,4) = Minimum altitude (meters) at which the sensor can be 
used 

ROME(IEQ,5) = Maximum altitude (meters) at which the sensor can be 
used 

ROME(IEQ,6) = Maximum angle the sensor can view. Input as SINE 

ROME(IEQ,7) = Currently not used (proposed: maximum doppler thres- 
hold rate of movement for the SLAR). 

ROME(IEQ,8) = Currently not used (proposed: minimum doppler thres- 


hold rate of movement for the SLAR). 
Air to Ground sensor data needed: 
The maximum and minimum rate of movement of the og os at which the target 


can be detected by the Side Looking Airborne Radar (SLAR). For test purposes 
these constants are in the program at 600 meters/min and 27 meters/min. 


The AIRGRND subroutine uses the following data statements for the sensor 
equipment type numbers: 


LOCAL ARRAY NAME SENSOR TYPE CURRENT EQUIPMENT 
Oe et eee PS 4 TYPE NUMBER 

ISENSR (1) VISUAL 0 

(not used) 

ISENSR (2) SLAR 5] 

ISENSR (3) INFRARED 55 

ISENSR (4) KA30 CAMERA 52 

ISENSR (5) KA60 CAMERA 53 

ISENSR (6) 36" VERTICAL CAMERA 54 


The use of data statements does not allow the sensor types to be 
position independent in the data base. 


The program is written so that the cameras must be assigned the sensor 
index of 4, 5, 6. 
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Gathering the data and inputting it to the model, etc., is covered in 
detail by the general steps listed in Section 6.2.1. 


6.2.2.4 How to Change the Weapon Effects Data 


Table 6-1 of this User's Manual shows the weapon effects deck to be 
discussed on page 60 of the Data Base/Operations Manual. This deck does 
contain all the variables needed to describe the effects of ground fire. 
Sections 4.1, 4.2, and 4.8 of the User's Manual discuss and also name all] 
the variables in this deck. In this case, the SORT/LIST (programs described 
in Appendix A) search produces Only one of the variables needed as shown 
below in Table 6-34. 


Table 6-34. Variable Indexed on ICDEF 
Ad 2 En ag a) Sen eae 
GROUPINGS OF FOUR CONSTANTS (J) TC BF USED WITH 
THE ICCEFHTH EFFECTS FUNCTICNS (i<eloCcbF<#315) 


A complete list of the variables that might be changed for new ground 
equipment weapon effects is shown below. 


NFC Number of entries in weapon effects look up 
table. 
NPFC Number of entries in weapon effects table 


involving personnel targets. 


IFNTB (I,J) Weapon effects look up table is of the form 
SSXXYZZFADDD, where 


IFNTB(1,1) = SSXXYZZ 
IFNTB(I,2) = FADDD 


I = I - TH (l<=I<=1000) entry in the 
weapon effects look up table such that 


SS = operational state of target unit 
(00 => any state) 


XX = weapon type 


Y = mode of fire (0 => any mode) 

ZZ = target personnel vulnerability class 
or target equipment class (00 => any 
class) 
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mn 
i 


weapon effects function to be used 


A = allocation criterion for aimed fire 
Vs. equipment 


DDD = number of associated grouping of 
constants to be used with effects 
function (1-199) 


NXK Number of groupings of constants, EFFDAT, used 
in weapon effects computations. 


EFFDAT (ICOEF,J) Groupings of four constants (J) to be used with 
the ICOEF - TH effects functions. 
(1 <=ICOEF <= 315) 


NDISPR Number of entries in IDISPR list. 


IDISPER (IDF) Weapon type for which effect function 6(FIRING) 
is used. (1<= IDF <=10) 


DISPER (IDF,J) Constants for use in calculating fraction of 
rounds falling on the target unit where IDF 
is the index from IDISPR. (1<=IDF<=10), 
I<=J<=3 is the number of constants used. 
A search of the three miscellaneous decks shown in Table 6-1 yields 
only one other variable of possible interest, GAFl, which is used in cal- 


culating the probability that an air unit is hit by ground support fire. 


Again, the gathering and inputting of data is covered in the general 
steps described in Section 6.2.1. 


6.2.2.5 How to Change the Modes of Equipment Operation 


Table 6-1 of this User's Manual shows that the needed variables are 
listed beginning on page 100 of the Data Base/Operations Manual. The 
operations of these variables are described in Sections 4.17, 4.18, and 
4.26 of the User's Manual. Selecting index IMGDE from Table 6-27, and 
using this in the SORT/LIST programs described in Appendix A yields only 
the 4 variables used with the mode distribution table (shown on Table 
6-35), not the mode vectors or the selecting variables. 


The complete list of variables for the modes of equipment operation 


from the Data Base/Operations Manual (starting on page 100) or Sections 
4.17, 4.18, and 4.26 of the User's Manual is shown in Table 6-36. 
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Table 6-36. 


MURTAB (1,0) 


MUSLCT (I) 


NMU 
NRMU 
XMUTAB (I,J) 
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Modes of Equipment Operation Variables 


Represents the two break ranges (in meters) 
and three mode distribution vector numbers 

corresponding to each mode selection code | 
used to select mode distribution vectors as 
function of range. (1<=I1<=150, 1<=J<=5) 


Mode selection codes in the form WWXXYYZZ. 
Such that 


WW = weapon unit state 


XX = target unit state (=99 for no 
target) : 


YY = target unit type (=99 for no 
target) 


ZZ = equipment type (=99 for support 
fire weapon) 


00 in any position means equality of look up 
value. Equality means use MURTAB (I,J) 

(J = 1,5) to select mode distribution vector. 
(1<=I<=150) 


Number of mode distribution vectors. 
Number of mode selection codes. 


Mode distribution vectors. XMUTAB (I,J) is 
fraction of equipment operating in mode J 
when mode distribution vector I has been 
selected by use of tables MUSLCT and MURTAB, 
I = 1,80 and J = 1,8. 
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A search of the 3 miscellaneous decks listed in Table 6-1 yields only 
one variable of possible interest, NMODES, which is the maximum number of 
modes, currently set at 8. Since reducing this number would only reduce 
the spaces of IAMTE, IPVCE, ROFE, ROME, and XMUTAB which could be used, 
it probably will always be equal to 8. 


The remaining steps needed to change these variables and input them 


to the model are completely covered in the general steps described in 
Section 6.2.1. 
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APPENDIX A - NOMENCLATURE 


A.1 NOMENCLATURE PROGRAM DESCRIPTION 
A.1.1 General 


A list of CATTS global’ variables can be generated by means of two 
programs, SORT (Figure A-1) and LIST (Figure A-2), and an input deck of 
variable definitions. The input deck consists of a set of cards or card 
images for each variable defined. The first card for each variable con- 
tains the variable name, index names, if any, and the name of the common 
blocks the variable is in. Following this header card is a set of text 
cards that provide a description of the variable. Variable units and the 
allowable range of indexes are included in the description. 


Program SORT is used to input a list of variable definitions and to 
output the same list alphabetized by variable name. This output list is 
stored on disk for use by program LIST. The second program (LIST) is 
used to input listing requests and output listings of variables so 
requested. Subroutine SORT (Figure A-3) is utilized by both programs 
for alphabetizing lists of variable names. A standard bubble sort is 
used by this routine. Subroutine ERROUT (Figure A-4) is utilized by 
program SORT for printing error messages. 


A maximum of 10,000 input cards are allowed consisting of a maxi- 
mum of 4,000 separate variables. Program LIST may be run either as a 
batch job from the card reader or interactively from the CATTS main 
computer console. 


Program LIST is used to extract data for the various output options 
available, and to write the report requested. LIST will generate the 
following types of nomenclature lists: 


e All variables (alphabetized) 

e Specified variables only 

e All variables organized by common blocks 

@ Variables in specified common blocks only 

e Variables organized by index for all indexes 


@ Variables organized by index for specified indexes only 
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Programs SORT and LIST are set up to run on the CATTS £9 computer. 
The options available and the LIST variable values that correspond to 
them are defined in the comment section at the beginning of the LIST 
listing. 


The remainder of this write-up contains a more detailed descrip- 
tion of the SORT and LIST programs, a discussion on how to use the 
programs (including control cards for use on the CATTS 29 computer 
system), commented listings of the routines, and a sample of input and 
Output data. 


A.1.2 Program SORT 


Program SORT, presented in the commented listing of Figure A-1, 
begins by reading in and processing the input data, a sample of which 
is shown in Figure A~5. Processing is performed on a card-by-card 
basis; if the first character position on the card is non-blank, the 
first eight characters on the card are placed in array IBUFF, followed 
by the number of the card containing the variable name. For example, 
if the 37th card read has VARIABLE starting in column 1, then IBUF(1,1) = 
4HVARI, IBUF(2,I) = 4HABLE and IBUF(3,I) = 37. "I" is an integer indicat- 
ing that this is the Ith variable card read. As soon as this processing 
is performed on each card, the card is written onto a temporary file. 
When all cards have been read in, the array IBUF is sorted (i.e., alpha- 
betized) by a call to subroutine SORT. 


Using the sorted array IBUF, program SORT then proceeds to set up 
the alphabetized mass storage file. Variable names are taken one at a 
time from array IBUF. The position on the temporary file containing the 
variable definition is noted. The variable description is then read from 
the temporary file and written to the permanent alphabetized file. This 
process is continued until all variable descriptions have been transferred 
to the permanent file. Finally, SORT prints all of the sorted card images. 


A.1.3 Program LIST 

Program LIST, presented in the commented listing of Figure A-2, is 
used to generate nomenclature reports. The reports it generates are all 
based on extracting data for specific variables, common blocks, or index 
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names. The first operation performed by the program is to read in the 
“type of listing (mode) that is being requested (see Section A.1.4 for 
mode descriptions). Next, the method of display of the mode is deter- 
mined. This is done by reading in the display method (see Section A.1.4 
for display methods). Next, it is determined whether sorting is required. 


Sorting is performed for all tasks except listing all variables. 
For each type of sorting (variable, common block or index) the permanent 
file is read sequentially and common block names, index names or variable 
names are searched for. As the desired text is found, it is stored in 
array IBUF along with a pointer indicating on what card image the text 
may be found. When all of the permanent file has been read, subroutine 
SORT is called to alphabetize the text strings found in IBUF. 


If sorting is not required, all variables are being requested and 
the permanent file is simply read card by card and listed. In all other 
cases, involving all variables, the alphabetized array IBUF is interro- 
gated entry by entry and the card numbers so found are read from the 
permanent file and listed along with all following cards until a new 
variable card is found. In cases where specific variables are requeste 
the variables are read one at a time. As each variable is read, refer- 
ences to it in IBUF are located and the permanent file entries pointed to 
are read and listed. Listing continues until a new variable card is read. 


A.1.4 Operation 


In order to perform the sorting and listing tasks outlined above, a 
large amount of disk area is required. Since such a large continuous area 
is not currently available on the CATTS system, a means of temporarily re- 
locating an area for sorting and listing was aevised. At the end of the 
listing and sorting task, this area is replaced as it appeared before the 
task. The area chosen for performing the listing and sorting task is 
area D5. This area currently holds file SAVE32 used for saving hours 13 
through 16 of a CATTS simulation. 


Two decks of cards (along with the nomenclature definition cards 
described in Figure A-5) are required for listing and sorting. The first 
deck, labelled SORT, is used to clear area D5, allocate files for the 
listing and sorting operations, compile the required programs and load 
these programs. The second deck, labelled FIX, is run at the conclusion 


—— 
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of the listing and sorting task. This deck re-allocates file SAVE32 in 
area D5. 


The user begins the listing and sorting task by loading the first 
deck of cards into the card reader. He then runs the job contained within 
this deck. When this job has concluded, the user is ready to begin the 
sorting operation. The steps performed in this task are as follows: 


1. Load the nomenclature definition cards into the card reader. 
(If another input medium, such as magnetic tape, is being 
utilized load the appropriate input device). 


2. Place a !EOD card at the end of the input card deck. (End 
of file mark on magnetic tape is required. ) 


* 3. Key interrupt TYC at the main console. 
4. Type ! JOB. 


5, .If the card reader is not being utilized as the input device 
type !STDLB (SI, device label), (e.g., !STDLB (SI, 9T)). 


6. Type !RUN D5,SORT. 
* If these control cards are input from the card reader, omit this step. 


At this point, all of the input cards will be read and an alpha- 
betized list of these cards will be printed on the line printer. The 
listing program is now ready for operation. Listing is accomplished by 
the following controlled cards. 


! JOB 


ISTDLB (SI, input device), (e.g., !STDLB (SI,TY) - 
for interection at main console). This card may be 
omitted if card reader is being used to input commands. 


!RUN D5,LIST 


At. this point, the program is waiting for commands from the input 
device. All commands must be input left justified. The first command 
describes the type or mode of sorting that is being requested. Three 
sorting types are available. These are: 
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LIST - list variables. In this mode, variables and their defini- 
tions will be listed. 


COMM - list common blocks. In this mode, common blocks along with 
all variables contained within them will be listed. 


INDX - list indexing variables. In this mode, variables used as 
indexes will be listed along with the variables that they 


index. 


After the sorting type has been selected, the program will be wait- 
ing for commands indicating which variables, common blocks or indexes are 


to be listed. Two bytes of input are accepted at this point. 

* - list all variables, common blocks or indexes alphabetically. 
or 

Variable | 


Variable 2 


Variable n 


* ~ list variables, common blocks, or indexes contained in this 
list. "*" indicates the end of the list. 


After the requested listings have been printed, the program will 
terminate. Alternate modes may now be accessed by simply rerunning LIST: 


!RUN D5,LIST 
and inputing new commands. 


When all desired listings have been obtained, the job making up the 
FIX deck should be run. 


Note: The math model will not be able to be run until FIX is executed. 
A.1.5 Data Format 
The input deck must have the following format. 


Header Card 


Index names, separated 
by commas, surrounded 
by ( ) (left justified - 


Common block 
name (left 
justified) 


Variable name 
(left justi- 
fied) 


Not Used 
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Text Cards 


Hollerith nomenclature text 
data 


There may be any number of text cards for each header card. 


A.2 NOMENCLATURE LIST 


This section presents an alphabetized listing of all of the variables 
(input and output) that are used in the CATTS mathematical model (background 
software). Included are definitions of the meaning of these variables, 
units of measurement, allowable range of indexes, and identification of the 
common blocks containing the variables. 


Also included, on the first line, are the names of the subroutines 
that read in the variables. These routine names appear in Table 6-1 of 
the User's Manual, and the information on this table will give the user 
the location of the data used for the variables on the Data Base file. 
This information also shows the user which of Sections 3 and 4 wil] 
provide more detail] on the variable. Two of the names are really input 
deck names: 


1) MISCVAR is the miscellaneous variable input deck at the 
front of the data base file, read by subroutine INPUT. 


2) NAMELIST means the namelist cards input at run time, or 
the namelist portion of the data base disk file (at the 
end of the file) both read by subroutine INPUT. Also 
refer to the Data Base/Operations Manual, Appendix A. 


Some of the variables, specifically LISTUN, LALL, LBATLN, LCOMPNY, 
LPLTN, NOALL, NOBATLN, NOCOMPNY, and NOPLTN, are filled by subroutine 
MKUNLIST processing data read in to create the values for the variables 
rather than simply reading the value from the data base into the vari- 
able. The values for most variables are simply read in straight from 
the data base disk file. 
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Text Cards 


Hollerith nomenclature text 
data 


There may be any number of text cards for each header card. 


A.2 NOMENCLATURE LIST 


This section presents an alphabetized listing of all of the variables 
(input and output) that are used in the CATTS mathematical model (background 
software). Included are definitions of the meaning of these variables, 
units of measurement, allowable range of indexes, and identification of the 
common blocks containing the variables. 


Also included, on the first line, are the names of the subroutines 
that read in the variables. These routine names appear in Table 6-1 of 
the User's Manual, and the information on this table will give the user 
the location of the data used for the variables on the Data Base file. 
This information also shows the user which of Sections 3 and 4 will 
provide more detail on the variable. Two of the names are really input 
deck names: 


1) MISCVAR is the miscellaneous variable input deck at the 
front of the data base file, read by subroutine INPUT. 


2) NAMELIST means the namelist cards input at run time, or 
the namelist portion of the data base disk file (at the 
end of the file) both read by subroutine INPUT. Also 
refer to the Data Base/Operations Manual, Appendix A. 

Some of the variables, specifically LISTUN, LALL, LBATLN, LCOMPNY, 
LPLTN, NOALL, NOBATLN, NOCOMPNY, and NOPLTN, are filled by subroutine 
MKUNLIST processing data read in to create the values for the variables 
rather than simply reading the value from the data base into the vari- 
able. The values for most variables are simply read in straight from 
the data base disk file. 
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